chore: API documentation sync - #618

Greptile Summary

This automated synchronization expands the CustomHealth script API documentation with the Lua input/output contract, an example, supported statuses, and a link to the full guide.

• Documents the global Obj input and healthStatus output.
• Clarifies that returning a Lua table is not consumed.
• Lists intended health statuses and links to the custom-health guide.

Confidence Score: 4/5

The PR appears safe to merge, with a non-blocking documentation inconsistency around the Paused custom-health status.

The new API-reference text links readers to a guide that omits one status included in the changed exhaustive list, leaving conflicting guidance but no demonstrated runtime defect.

Files Needing Attention: pages/api-reference/kubernetes/agent-api-reference.md

_{Reviews (1): Last reviewed commit: "sync docs" | Re-trigger Greptile}